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1. INTRODUCTION 


The Floppy Disk Utility controls the transfer of programs from the hard disk 
to the floppy disk and vice versa. It will also copy the data on a floppy 
disk to another floppy disk and compare the data of two floppy disks. 

The program operates under the Data General N0VA-4X Real Time Disk Operating 
System (RDOS). 
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2. OPERATOR INTERFACE 


The operator controls the transfer of data via inputs from the Cathode Ray 
Tube (CRT) keyboard. (Or any system console device.) 

The programs request operator input by displaying an exclamation mark (!). 
The operator respoi.Js with a string of control characters which direct the 
programs to perform an operation. Additional input, necessary to perform 
the operation, is requested via displays on the CRT. 

If an er or occurs during an operation, the following message is displayed: 
STATUS SSSS U TTTT 

Where: SSSS is the status in octal (see Appendix E for the format of 
the status register). 

U is the unit number. 

TTTT is the track number in octal. 

One of the more common operator errors involving an operation on the floppy 
disk is specifying a floppy operation to a unit that dees not contain a 
diskette. The above message will be displayed. However, the error bit 
(bit 15) will be zero. 

The operations and the operator interface are described below. Operator in- 
put is underlined. 

2.1 DISPLAY MENU 
!M 

The commands and their functions are displayed. (See Appendix A for a sampl 
of the display.) 
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2.2 UNIT 


lU 

UNIT (0-1) u U 

The current floppy unit is u. The operator may change units by typing a 0 or 
1. If the operator responds with a carriage return and no unit value, the 
unit remains the same. 

Also, these operations cause the floppy unit u updated program directories to 
be copied onto unit u, if necessary. The unit need not be changed to cause 
the copy. (See Appendix B for a description of the program directories.) 

2.3 DISPLAY PROGRAM DIRECTORY 
IP 

The program directories for the current floppy are displayed one directory 
at a time, beginning with program directory 0. Pressing carriage return 
terminates the display. Pressing any other key causes the next directory to 
be displayed. If there ar^ no more directories, the display is terminated. 
(See Appendix B for a description of the directories.) 

2.4 READ FLOPPY PROGRAM FILE 
!RF 

PROGRAM NUMBER p P_ 

Where: p is the current program number. 

£ is the operator response. 

Carriage return will cause program file p to be read. 

A numeric response (1-9) will cause the specified 
file to be read. Any otlier response will cause a 
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question mark (?) to be displayed and the operation 
terminated. 

If the program file is not defined on the floppy, the message 

UNDEFINED PROGRAM 
is displayed. The operation will be terminated. 

If a status error ‘ detected, the message, STATUS, the floppy status, the 
unit number, and the track number are displayed (octal format). The opera- 
tion is terminated. 

2.5 WR ITE FLOPPY PROGRAM FILE 


PROGRAM NUMBER p P 

FLOPPY PROGRAM NAME xxxxxj 

START ADDRESS s S 

END ADDRESS e E 


Where: p is the current program number. 

£ is a carriage return if the program file to be written 
is p or a digit (1-9) if another program is to be written. 
xxxxx is the program name terminated by a carriage return or 
the input of 12 alphanumeric characters, 
s is the start (low) address of the program. If the program 
was read from hard disk, s is zero (0). If the program was 
read from the floppy disk, s is taken from the program 
directory. 

^ is a carriage return if s is the start address. Otherwise 
it is an octal value terminated by a carriage return, 
e is the end (high) address. It is taken from \vord A04g (NMAX) 
of the file if the program was read from the hard disk. If 
the program was read from the floppy disk, the end address i 
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taken from the program directory, 

IE is a carriage return if e is the end address. Otherwise, 
to set another end address, £ is an octal number termi- 
nated by a carriage return. 

If no program is in core, the message 

NO PROGRAM 

is displayed when the "W" of the command is input. 


If the preceding program file number has not been defined in the current 
floppy unit's directory, the message 

NONCONTIIUOUS FILE 

will be displayed and the operation terminated. 

If during the write operation an error is detected, the message, STATUS, the 
floppy status, the unit number, and the track number are displayed (octal 
format). WARNING: All higher numbered files will be deleted after a WF 

command! 

2.6 READ HARD DISK FILE 
IF^ 

DISK FILE NAME xxxxx 

Where: xxxxx is blank or the previous hard disk file name processed. 

Appropriate operator response is a return to read file xxxxx or a file name 
terminated by a carriage return. (The file name must be compatible with RDOS 
conventions.) If an error occurs during the; read operation, a question mark 
and the RDOS error code are displayed. (See Appendix C for the RDOS error codes.) 
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2.7 WRITE HARD DISK FILE 


IWD 

DISK FILE NAME xxxxx 

Where: xxxxx is blank or the name of the previous hard disk 
file processed. 

Appropriate operator response is a return if the file to be written is xxxxx 
or a file name terminated by a return. To be written, the file must not be 
defined when this command is given. To delete a file see DELETE HARD DISK 
FILE (section 2.10). If an error is detected, a question mark and the RDOS 
error code are displayed. (See Appendix C for the RDOS error codes.) 

If no program is in core, the message 

NO PROGR/'.M 

is displayed when the character "W" is input by the user. 

2.8 FORMAT AND WRITE BOOTSTRAP LOADER 
!F0 

The floppy on unit u is formatted. If a status error occurs during formatting, 
the process is terminated, the message STATUS, the unit number, and the status 
are displayed. 

If formatting is successful, ‘'he name of the hard disk bootstrap loader file 
is requested by 


DISK FILE NAflE xxxxx 

Where: xxxxx is blank or the previous program request. 
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The appropriate operator response is a return If xxxxx Is the na<ae of the 
bootstrap loader file. If it is not the n^aire of the file, the operator 
should respond with th£ nan« followed by a return. 

If the file cannot be read from the hard disk, a question mark and the RDOS 
error code are displayed. (See Appendix C for the RDOS error codes.) If an 
error occurs during the floppy write operation, the message, STATUS, the 
floppy status, the unit number, and t'le track nun^er are displayed (octal 
format). 

Any programs read into core from a floppy or hard disk before the format 
operation are not available for transfer to the floppy or hard disk. 

2.9 EXIT 
IX 

This command copies the updated directory, if necessary, onto the current 
unit and exits to RDOS. 

A floppy disk should not be removed from the drive until this cotmtand is 
executed because of the potential for losing the updated directory . 

2.10 DELETE HARD DISK FILE 
ID 

DISK FILE NAME xxxxx 

Where; xxxxx is blank or the name of the previous hard 
disk file processed. 

Appropriate response is a return If xxxxx is the file to be deleted or the 
name of the file name terminated by a return. 

If the file cannot be deleted, a question mark and the RDOS error code are 
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displayed. (Sf.e Appendix C for the RDOS error codes.) 


2.11 COPY 
INPUT 

UNIT (0-1) u U 

Where: u is the current unit. 

IJ is either a carriage return or a 0 or 1. If £ is a 
carriage return, u will be the input unit. If JJ is 
a 0 or 1 then £ is the input unit. The other unit 
is the output unit. Any other response from the 
operator will cause a question mark to be displayed 
and the operation terminated. 

The output unit is formatted and the data on the input unit is copied from 
the input unit onto the output unit. All 76 tracks are copied. If an c;ro» 
is detected, the message, STATUS, the number of the offending unit, and the 
unit status are displayed. The operation is terminated. 

Since all 76 tracks are copied, the data need not be in Data Systems Labora- 
tory Floppy (DSLF) Format. 

2.12 VERIFY 
!V 

VERIFY ALL TRACKS - YES (Y), f!0 (N) Y 

or 

!V 
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VERIFY ALL TRACKS - YES (Y). NO (N) N 

UNIT 0 

PROGRAM NUMBER Pq 

UNIT 1 

PROGRAM NUMBER p^ Pj 

In the first case, all 76 tra s of unit 0 are conpared v/ith all 76 tracks of 
unit 1. Therefore, the floppy disk need not be in DSLF format. 

In the second case, the specified program data on unit 0 is compared with the 
specified program of unit 1. The data of both floppy disks must be in DSLF 
format. If the tv/o programs do not occupy the same number of tracks the 
error message 


PROGRAM LENGTH 

is displayed and the operation is terminated. 

In both cases if an error is defected during the compare, the format of the 
error message is as follows: 


Where: "'"g is the unit 0 track number. 

Wg is the unit 0 v.'ord number with the track (0-3177). 

Dg is the unit 0 data word in error. 

Tj is the unit 1 track numl>er. 

Dj is the unit 1 data word in error. 

All displays are in octal. 

When an error is displayed, the verification process is halted awaiting an 
operator response. Appropriate lesponses are: 
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Carriage return terminates verification. 

Line feed causes the verification to be continued with the next track. 
Any other character causes verification to be continued with the next 
word. 

If a status error occurs, the message STATUS, the floppy status, the 
unit nuit4)er and track nuirfeer are displayed (octal format). The 
operation is terminated. 

2.13 WRITE BOOTSTRAP LOADER ON THE FLOPPY 
!L 

DISK FILE NAME xxxxx 

Where: xxxxx is blank or the hard disk file name of the previous 
program read from hard disk. 

Appropriate operator response is a return if xxxxx is the hard disk file 
name of the bootstrap loader or the file name of the bootstrap loader 
terminated by a return. 

If the file cannot be read, a question mark and the RDOS error code are dis- 
played. (See Appendix C for the RDOS error codes.) If an error occurs 
during the floppy write operation, the message, STATLiS, the floppy status, 
the unit number and track number are displayed (octal format). 

2.14 TRANSFER DISK TO FLOPPY 
ITT 

DISK FILE NAI1E wwwww xxxxx 

PROGRAM NUMBER p £ 

FLOPPY PROGRAM NAME yyyyy^ 

Where: is either blank or the previous hard disk file name 
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processed. 

xxxxx is the file name to be processed terminated by a carriage 
return. If file wwwww Is to be transferred, then the 
appropriate response Is a carriage return, 
p Is the current program number. 

£ Is a carriage return if the program file to be written Is p 
or a digit (1-9) If another program is to be written, 
yyyyy is the program name terminated by a carriage return or 
the Input of 12 alpha-numeric characters. 

This command is used normally to transfer non-save files to the floppy or 
large save files (greater than 20,000 words) to the floppy. 

The Transfer Disk to the Floppy sets the START ADDRESS in the directory to 0. 
The END ADDRESS in the directory is 

256io*B 

Where; B is the number of 256 word blocks in the hard disk file. 

The hard disk file is not saved in memory and therefore a TF command followed 
by a write floppy (WF) or write disk (WD) will result in the following error 
message 

NO PROGRAM 

Since the TF command causes the hard disk to be read, potential error messages 
include a question mark followed by the RDOS error code (see Appendix C for 
the RDOS error codes). If the preceding floppy program file is not defined, 
the message 


NONCONTIGUOUS FILE 

will be displayed and the operation terminated. If an error occurs during 
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the floppy write operation, the message, STATUS, the floppy status, the unit 
number and track number are displayed. 

2.15 TRANSFER FLOPPY TO DISK 
IJD 

PROGRAM NUMBER p P 

DISK FILE NAME wwwww xxxxx» 

Where: p is the current program number. 

P is a carriage return if the program file to be transferred is 
p or a digit (1-9) if another program is to be transferred. 

wwwww is either blank or the previous hard disk file name 
processed. 

xxxxx is the file name of the hard disk file to which the floppy 
program is to be transferred. To be written, the file must 
not be defined when this command is given. To delete a file, 
see DELETE HARD DISK FILE (section 2.10). 

This command is a companion to the Transfer Disk to Floppy (TF) command. It 
is used to transfer non-save or very large save files (greater than 20,000 
words) from floppy to the disk. 

The floppy file is not saved in memory and therefore a TD command followed by 
a write floppy (WF) or write disk (WD) will result in the following error 
message. 


NO PROGRAM 

If the floppy file to be transferred has not been defined, the following 
error message is displayed. 


NO PROGRAM 
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since the TD command causes the hard disk to be written, potential error mes- 
sages Include a question mark followed by the RDOS error code (see Appendix 
C for the RDOS error codes). If an error occurs during the floppy read 
operation the message, STATUS, tho floppy status, the unit number and track 
number are displayed (octal format). 
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3. OPERATING INSTRUCTIONS 


The Floppy Disk Utility is in directory DPOFrAKERSOF. The name of the pro- 
gram is FLOPM, 

Samples of common operations are illustrated in Appendix E. 
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APPENDIX A 


FLOPPY DISK UTILITY COf^MANDS 


APPENDIX A 


FLOPPY DISK UTILITY COMMANDS 

MENU M 

UNIT U 

DISPLAY DIRECTORY P 

READ FLOPPY RF 

WRITE FLOPPY WF 

READ DISK RD 

WRITE DISK WD 

FORMAT FLOPPY FO 

EXIT X 

DELETE DISK FILE D 

COPY C 

VERIFY V 

LOADER L 

DISK TO FLOPPY TF 

FLOPPY TO DISK TD 
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APPENDIX B 


DATA SYSTEMS LABORATORY FLOPPY (DSLF) FORMAT 


APPENDIX B 


DATA SYSTEMS LABORATORY FLOPPY (DSLF) FORMAT 

The program data stored on the disk will consist of a bootstrap load program, 
the program directories, and the program data. 

The bootstrap loader occupies track 0, sector 1 through track 1, sector 15g. 

The program directories occupy track 1, sector 16g through track 1, sector 
27g. The directories define each program, its location on the floppy, and 
its core memory starting (low) address and stop (high) address. Each direc- 
tory occupies one sector. The format of the directories is as follows. 


WORD 

0-11 Program file name - one character per word right 

justified 

12 start (low) address 

13 stop (high) address 

14 - 21 date - one character per word right justified. The 

format of the date is as follows, MM/DD/YY Where: 
MM is the number of the month, DD is the day of the 
month, YY is the year, 

22 start track of the program file 

23 number of the tracks in the file 

24 last track of the program file 

25 next available track (last track + 1) 

26 - 64 Zero 


Program files begin at track 2, sector 1, Each file begins at the track 
boundary, i,e., sector 1, 
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APPENDIX C 
RDOS ERROR CODES 


APPENDIX C 


RDOS ERROR COOES 


The following describes the ilDOS error codes that may occur during operation 
of the Floppy Disk Utility program. A more comnlete descripcion of the 
errors is in the Data General document. Real Time Disk Operation System (RODS) 
Reference Manual, 


ERROR CODE 
1 

7 

10 

11 

12 

13 

52 

101 


OESCRIPTION 

Illegal file name (only alphanumeric or $ characters 
are permitted) 

The file is read protected 

The file is write protected 

The file already exists 

The file does not exist 

The file cannot be deleted because it has the 

permanent attribute 

Illegal directory specifier 

Oisk timeout occurred 
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APPENDIX D 


FLOPPY STATUS REGISTER 


APPENDIX 0 

FLOPPY STATUS REGISTER 


DONE 

SEEK 
: DONE 






UN- 

SAFE 

UNIT 

RDY 

SE-K 

EFR 

END 

ERR 

AODR 

ERR 

CHK 

ERR 

DATA 

LATE 

ERR 

1 

UNIT 
0 1 



B 

B 

0 









0 

1 2 

3 

4 

5 

6 

7 

8 

9 

10 

11 

12 

13 

14 

15 


BITS 

NAME 

MEANING WHEN 1 

0 

DC Done 

The subsystem has con^leted a Read or a Wiite 
Operation. 

1-2 

Seek Done 

Drive 0-1, respectively, has completed a Seek 
or Recalibrate operation. More than one of 
these bits can be set at any time. 

3-4 

— 

Reserved for future use. 

5 

Diskette (D) 

Indicates that selected unit is a diskette 
if D-1. 

6-7 

- — 

Reserved for future use. 

8 

Unsafe 

The selected drive is in an unsafe condition. 
The unsafe flag can be reset with a CLR, 
lOPLS, lORST, or STRT. 

9 

Unit Ready 

The selected drive is not performing an" head 

• 


movements and is ready to carry out a command 
(Read, Write, or another Seek). 

10 

Seek Error 

The selected drive was not able to carry out 
a Seek or Recalibrate operation issued. 
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BITS 


NAME 


MEANING WHEN 1 


11 

End of 
Diskette 

The selected drive attempted to start Read or 
Write operation beyond the 76th track of a 
diskette. 

12 

Address 

Error 

Starting sector (SS) does not fall within the 
following range: l£SS£32g. 

13 

Checkword 

Error 

The checkword re id from the diskette at the 
end of a sector does not match the checkword 
calculated by the controller. 

14 

Data Late 

Data transfer error internal to DFDD 
controller. 

15 

Error 

One or more of the bits 8, 10, 11, 12, 13, or 
14 ill the Status Register Is set to 1. 
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SAMPLE OPERATIONS 


APPENDIX E 


SAMPLE OPERATIONS 

Below are given two examples that illustrate the major uses of the floppy disk 
utility. Operator inout is underlined, and carriage return is represented 

by). 

Copy hard disk file, MONIT.SV onto the floppy disk unit 1, program file 1. 


!U 

UNIT (0-1) 0 _1 

•M 

DISK FILE NAME 
MONIT.SV 
!WF 

PROGRAM NUMBER 1 i 

FLOPPY PROGRAM NAME MONITOR P 

START ADDRESS 000000 I 
STOP ADDRESS 012517 ^ 

!X 

R 
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Copy floppy disk unit 1, program number 1 onto unit 0, program number 3 
Verify the transfer. 


!U 


UNIT (0 - 1) 

0 1 

!RF 


PROGRAM NUMBER 

1 A 

!U 


UNIT (0 - 1) 

1 0 

•ML 


PROGRAM NUMBER 

1 3 

FLOPPY PROGRAM NAME 

MONITOR ) 


START ADDRESS 000000 P 
STOP ADDRESS 012517 I 
!V 

VERIFY ALL TRACKS YES (Y), NO (N) N 
UNIT 0 

PROGRAM NUMBER 3 p 

UNIT 1 

PROGRAM NUMBER 3 1_ 

!X 

R 
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